home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / as / dist / README < prev    next >
Encoding:
Text File  |  1989-05-31  |  3.3 KB  |  75 lines
  1. This is the beta-test version of the GNU assembler.  (Probably
  2. around Version 1.34, but check version.c which gets updated more
  3. often than this readme.)  Please report bugs, missing features, etc
  4. to hack@gnu.ai.mit.edu (Jay Fenlason) If that address doesn't work,
  5. try hack@prep.ai.mit.edu or hack@media-lab.media.mit.edu (ONE of
  6. them should work.  If you get *REALLY* desparate, try
  7. hack@lsrhs.UUCP )
  8.  
  9. The assembler has been modified to support a feature that is
  10. potentially useful when assembling compiler output, but which may
  11. confuse assembly language programmers.  If assembler encounters a
  12. .word pseudo-op of the form symbol1-symbol2 (the difference of two
  13. symbols), and the difference of those two symbols will not fit in 16
  14. bits, the assembler will create a branch around a long jump to
  15. symbol1, and insert this into the output directly before the next
  16. label:  The .word will (instead of containing garbage, or giving an
  17. error message) contain (the address of the long jump)-symbol2.  This
  18. allows the assembler to assemble jump tables that jump to locations
  19. very far away into code that works properly.  If the next label is
  20. more than 32K away from the .word, you lose (silently) RMS claims
  21. this will never happen.  If the -k option is given, you will get a
  22. warning message when this happens.
  23.  
  24. These files are currently set up to allow you to compile all of the
  25. versions of the assembler (68020, VAX, ns32k, and i386) on the same
  26. machine.  To compile the 68020 version, type 'make a68'.  To compile
  27. the VAX version, type 'make avax'.  To compile the ns32k version,
  28. type 'make a32k'.  To compile the Intel 80386 version, type 'make
  29. a386'.  The Makefile contains instructions on how to make one of the
  30. assemblers compile as the default.
  31.  
  32. Before you can compile the 68020 version of the assembler, you must
  33. make m68k.h be a link to m-sun3.h , m-hpux.h or m-generic.h .  If
  34. you are on a SUN-3 (or other machine that uses a magic number of
  35. (2 << 16) | OMAGIC type 'ln -s m-sun3.h m68k.h' else if you are on a
  36. machine running HP-UX, type 'ln m-hpux.h m689k.h' else type
  37. 'ln -s m-generic.h m68k.h' If your machine does not support symbolic
  38. links, omit the '-s'.
  39.  
  40. If your machine does not have both varargs.h and vfprintf(), but does have
  41. _doprnt() add -DNO_VARARGS to the CFLAGS line in the makefile.  If your
  42. machine has neither vfprintf() or _doprnt(), you will have to change
  43. messages.c in order to get readable error messages from the assembler.
  44.  
  45.  
  46.     REPORTING BUGS IN GAS
  47.  
  48. If you report a bug in GAS, please remember to include:
  49.  
  50. A description of exactly what went wrong.
  51.  
  52. The type of machine GAS was running on (VAX, 68020, etc),
  53.  
  54. The Operating System GAS was running under.
  55.  
  56. The options given to GAS.
  57.  
  58. The actual input file that caused the problem.
  59.  
  60. It is silly to report a bug in GAS without including an input file for
  61. GAS.  Don't ask us to generate the file just because you made it from
  62. files you think we have access to.
  63.  
  64. 1. You might be mistaken.
  65. 2. It might take us a lot of time to install things to regenerate that file.
  66. 3. We might get a different file from the one you got, and might not see any
  67. bug.
  68.  
  69. To save us these delays and uncertainties, always send the input file
  70. for the program that failed.
  71.  
  72. If the input file is very large, and you are on the internet, you may
  73. want to make it avaliable for anonymous FTP instead of mailing it.  If you
  74. do, include instructions for FTP'ing it in our bug report.
  75.